SitC Lister is a utility for TeleFinder, FirstClass, and NovaLink Professional sysops, which allows the listing of their BBS file directories into text files, complete with descriptions. This is done by extracting the SitC=0 resource out of the individual files. SitC Lister begins in a directory of your choice and recursively lists all files and subdirectories contained in that directory. A user specified header and footer can be applied to the output files. The user has the option to output the file's complete path, the description, and the file's size. The output files will be written to the user-specified location, overwriting any existing output files.
I use this utility to create the magic FILES and ALLFILES listing that FIDONet uses in File Requests. I also use this utility to produce text files at the root level of each of my file library folders, containing a list of what is in the folder and all it's sub-folders. I list the paths but no descriptions in the ALLFILES list since with approximately 3000 FREQable files, it would get too big to include the descriptions.
SitC Lister is shareware, with a $25 fee. If you don't register, fine, but you will only be able to create 2 files. Even if you don't register, I would greatly appreciate an EMail or postcard letting me know that you are using the software. Bug reports are always welcome.
SitC Lister may only be distributed by Arizona Macintosh Users Group on CD-ROM or media over 2 Mb in size.
2) limit of 32 file specifications (when registered; non-registered users have a limit of 2 file specifications).
Installation
"Creating Interactive" means files that will be created when SitC Lister is launched and the "Go" command chosen from the options menu. "Creating Batch" means files that will be created when SitC Lister is launched in the presence of a launch.next file, found in Tabby systems. In other words, you will need to put your SitC Lister application in the same folder with your BBS if you want to use this feature. If not, then you can put it anywhere.
1) Create a header and a footer file for each directory listing you are going to create. Hint: I create one footer file for everything, one header file for FIDONet File Request files (FILES and ALLFILES), and one header file for each File library directory I create (e.g., Desk Accessory Files, or HyperCard Stacks). Use any Text Editor to do this, but the headers and footers MUST be text only.
2) Launch SitC Lister and select "Configure Files".
• select the source by clicking the "Source" button and select any directory you want to list using the Open dialog.
• select the destination by clicking the "List File" button and use the Save As dialog to define your destination file.
• select the header file and footer file using their respective buttons and the resulting Open dialog.
• define what things you want listed in the destination file, and use the checkboxes to select them.
• Finally hit the "Add" button to add the entry.
• Repeat the above process until you are ready.
• By selecting an entry that is "kind of" like your desired new entry, and modifying its parameters, then hitting the add button, you can quickly define a bunch of files.
• Close the dialog with the "OK" button.
• Select "Go" from the Options Menu.
• Your files will be written.
Changing File Entries
• in the "Configure Files" dialog, select an entry to change. Modify the path, destination, or checkboxes as you see fit, then hit the "Change" button. If you select any other entry in the list before hitting the Change button, your changes will be lost.
Removing File Entries
• Select the Entry
• Hit the remove button.
Listing More than One Source Directory to A Single Output File
• Select the "Hdrs&Ftrs" checkbox on the first entry for that output file
• De-Select the "Hdrs&Ftrs" checkbox on the rest of the entries for that output file. That way only one header and one footer will be written.
Setting The Creator Type of Output Files
• Select "Preferences…" and type in the creator of the text editor you want output files to be.
Running as a Tabby event
• Select "Preferences…" and check the "Run as Tabby Event with launch. next" box. If SitC Lister is launched in the presence of a launch.next file, all entries flagged "Create Batch" will be created. The end of the Zone Mail Hour event would be an opportune time to run SitC Lister. Customizing SitC Lister • All of the menus, strings, dialogs, and alerts are in the resource fork of the program. The error strings are in STR#=129 and the status strings are in STR#=128. You can edit those, especially the status strings, if you don't like what it writes to disk or the screen. If anyone makes an international version of SitC Lister, I would appreciate a copy.
Manually Editing the Prefs File
• The SitC Lister.Prefs file is merely a text file with the various parameters, paths, and flags on it. You can edit it with any text editor. if something is wrong with your Prefs file, you will get error messages when you launch SitC Lister.
Structure of SitC Lister.Prefs File
Line What it Contains
____ ________________
1 Number of Output Files
2 1 to use Launch.Next to do batch processing in Tabby events; 0 to not use.
3 Source Directory Path For Listing -- ends in ":" -- case sensititive
4 Output File Complete Path -- case sensititive
5 Header File -- leave blank if no headers are desired -- case sensititive
6 Footer File -- leave blank if no footers are desired -- case sensititive
7 1 if file size is to be written; 0 if not
8 1 if description is to be written; 0 if not
9 1 if path to file is to be written or 0 for just filename
10 1 if the header is to be added; 0 if not
11 1 if footer is to be added; 0 if not
12 1 if a file is to be created in interactive mode; 0 if not
13 1 if a file is to be created in batch mode; 0 if not
*** Repeat Lines 3 through 13 for more output files
*** remember to change line 1 to number of files.
*** following are the last 2 lines of the file.
*** put a carriage return at the end.
14 1 if you want name and size on same line; 0 if not
